
<!DOCTYPE html>
<!--

    Copyright (c) 2017, 2019 Oracle and/or its affiliates. All rights reserved.

    This program and the accompanying materials are made available under the
    terms of the Eclipse Public License v. 2.0, which is available at
    http://www.eclipse.org/legal/epl-2.0.

    This Source Code may also be made available under the following Secondary
    Licenses when the conditions for such availability set forth in the
    Eclipse Public License v. 2.0 are satisfied: GNU General Public License,
    version 2 with the GNU Classpath Exception, which is available at
    https://www.gnu.org/software/classpath/license.html.

    SPDX-License-Identifier: EPL-2.0 OR GPL-2.0 WITH Classpath-exception-2.0

-->
<!-- Portions Copyright [2019] [Payara Foundation and/or its affiliates] -->
<html lang="en">
  <head>
    <meta charset="utf-8"/>
    <title>create-node-config</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <link href="css/style.css" rel="stylesheet">
    <script src="https://use.fontawesome.com/96c4d89611.js"></script>
  </head>
  <body>
<table id="doc-title" cellspacing="0" cellpadding="0">
  <tr>
  <td align="left" valign="top">
  <b>create-node-config</b><br />
  </td>
  </tr>
</table>
<hr />

<table width="90%" id="top-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>
		<td align="left">
		<a href="create-network-listener.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="create-node-dcom.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class=" vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>


<div id="preamble">
<div class="sectionbody">
<div class="paragraph">
<p><a id="create-node-config-1"></a><a id="GSRFM00047"></a><a id="create-node-config"></a></p>
</div>
</div>
</div>
<div class="sect1">
<h2 id="_create_node_config">create-node-config</h2>
<div class="sectionbody">
<div class="paragraph">
<p>creates a node that is not enabled for remote communication</p>
</div>
<div id="sthref445" class="paragraph">
<p>Synopsis</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin [asadmin-options] create-node-config [--help]
[--nodehost node-host]
[--installdir as-install-parent] [--nodedir node-dir] node-name</code></pre>
</div>
</div>
<div id="sthref446" class="paragraph">
<p>Description</p>
</div>
<div class="paragraph">
<p>The <code>create-node-config</code> subcommand creates a node that is not enabled
for remote communication. The <code>create-node-config</code> subcommand does not
require the Distributed Component Object Model (DCOM) remote protocol or
secure shell (SSH) to be configured to create the node.</p>
</div>
<div class="paragraph">
<p>A node represents a host on which the \{product---name} software is
installed. A node must exist for every host on which \{product---name}
instances reside.</p>
</div>
<div class="admonitionblock note">
<table>
<tr>
<td class="icon">
<div class="title">Note</div>
</td>
<td class="content">
<div class="paragraph">
<p>To represent the host where the DAS is running, \{product---name}
provides the predefined node `localhost-`domain. The predefined node
`localhost-`domain is not enabled for remote communication.</p>
</div>
</td>
</tr>
</table>
</div>
<div class="paragraph">
<p>All administration of instances on a node that is not enabled for remote
communication must be performed on the host that the node represents.
The domain administration server (DAS) on a remote host cannot contact
the node. To administer instances on a node that represents a host that
is remote from the DAS, you must use the following subcommands:</p>
</div>
<div class="ulist">
<ul>
<li>
<p><a href="create-local-instance.html#create-local-instance-1"><code>create-local-instance</code>(1)</a></p>
</li>
<li>
<p><a href="delete-local-instance.html#delete-local-instance-1"><code>delete-local-instance</code>(1)</a></p>
</li>
<li>
<p><a href="start-local-instance.html#start-local-instance-1"><code>start-local-instance</code>(1)</a></p>
</li>
</ul>
</div>
<div class="paragraph">
<p>However, you may use
<a href="stop-local-instance.html#stop-local-instance-1"><code>stop-local-instance</code>(1)</a>
or <a href="stop-instance.html#stop-instance-1"><code>stop-instance</code>(1)</a> to stop
the instances.</p>
</div>
<div class="paragraph">
<p>This subcommand is supported in remote mode only.</p>
</div>
<div id="sthref447" class="paragraph">
<p>Options</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">asadmin-options</dt>
<dd>
<p>Options for the <code>asadmin</code> utility. For information about these
options, see the <a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a> help page.</p>
</dd>
<dt class="hdlist1"><code>--help</code></dt>
<dt class="hdlist1"><code>-?</code></dt>
<dd>
<p>Displays the help text for the subcommand.</p>
</dd>
<dt class="hdlist1"><code>--nodehost</code></dt>
<dd>
<p>The name of the host that the node represents. If this option is
omitted, no host is specified for the node.</p>
</dd>
<dt class="hdlist1"><code>--installdir</code></dt>
<dd>
<p>The full path to the parent of the base installation directory of the
\{product---name} software on the host, for example,
<code>/export/glassfish3/</code>. If this option is omitted, no parent of the
base installation directory of the \{product---name} software is
specified for the node.</p>
</dd>
<dt class="hdlist1"><code>--nodedir</code></dt>
<dd>
<p>The path to the directory that is to contain \{product---name}
instances that are created on the node. If a relative path is
specified, the path is relative to the as-install directory. If this
option is omitted, no directory for instances is specified for the
node.</p>
</dd>
</dl>
</div>
<div id="sthref448" class="paragraph">
<p>Operands</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">node-name</dt>
<dd>
<p>The name of the node.<br>
The name must meet the following requirements:<br></p>
<div class="ulist">
<ul>
<li>
<p>The name may contain only ASCII characters.</p>
</li>
<li>
<p>The name must start with a letter, a number, or an underscore.</p>
</li>
<li>
<p>The name may contain only the following characters:</p>
<div class="ulist">
<ul>
<li>
<p>Lowercase letters</p>
</li>
<li>
<p>Uppercase letters</p>
</li>
<li>
<p>Numbers</p>
</li>
<li>
<p>Hyphen</p>
</li>
<li>
<p>Period</p>
</li>
<li>
<p>Underscore</p>
</li>
</ul>
</div>
</li>
<li>
<p>The name must be unique in the domain and must not be the name of
another node, a cluster, a named configuration, or a \{product---name}
instance.</p>
</li>
<li>
<p>The name must not be <code>domain</code>, <code>server</code>, or any other keyword that
is reserved by \{product---name}.</p>
</li>
</ul>
</div>
</dd>
</dl>
</div>
<div id="sthref449" class="paragraph">
<p>Examples</p>
</div>
<div class="paragraph">
<p><a id="GSRFM509"></a><a id="sthref450"></a></p>
</div>
<div class="paragraph">
<p>Example 1   Creating a Node That Is Not Enabled for Remote Communication</p>
</div>
<div class="paragraph">
<p>This example creates the node <code>sj03</code> for host <code>sj03.example.com</code>. The
node is not enabled for remote communication.</p>
</div>
<div class="listingblock">
<div class="content">
<pre class="prettyprint highlight"><code class="language-oac_no_warn" data-lang="oac_no_warn">asadmin&gt; create-node-config --nodehost sj03.example.com sj03

Command create-node-config executed successfully.</code></pre>
</div>
</div>
<div id="sthref451" class="paragraph">
<p>Exit Status</p>
</div>
<div class="dlist">
<dl>
<dt class="hdlist1">0</dt>
<dd>
<p>command executed successfully</p>
</dd>
<dt class="hdlist1">1</dt>
<dd>
<p>error in executing the command</p>
</dd>
</dl>
</div>
<div id="sthref452" class="paragraph">
<p>See Also</p>
</div>
<div class="paragraph">
<p><a href="asadmin.html#asadmin-1m"><code>asadmin</code>(1M)</a></p>
</div>
<div class="paragraph">
<p><a href="create-local-instance.html#create-local-instance-1"><code>create-local-instance</code>(1)</a>,
<a href="create-node-dcom.html#create-node-dcom-1"><code>create-node-dcom</code>(1)</a>,
<a href="create-node-ssh.html#create-node-ssh-1"><code>create-node-ssh</code>(1)</a>,
<a href="delete-local-instance.html#delete-local-instance-1"><code>delete-local-instance</code>(1)</a>,
<a href="delete-node-config.html#delete-node-config-1"><code>delete-node-config</code>(1)</a>,
<a href="install-node.html#install-node-1"><code>install-node</code>(1)</a>,
<a href="install-node-dcom.html#install-node-dcom-1"><code>install-node-dcom</code>(1)</a>,
<a href="install-node-ssh.html#install-node-ssh-1"><code>install-node-ssh</code>(1)</a>,
<a href="list-nodes.html#list-nodes-1"><code>list-nodes</code>(1)</a>,
<a href="start-local-instance.html#start-local-instance-1"><code>start-local-instance</code>(1)</a>,
<a href="stop-instance.html#stop-instance-1"><code>stop-instance</code>(1)</a>,
<a href="stop-local-instance.html#stop-local-instance-1"><code>stop-local-instance</code>(1)</a>,
<a href="uninstall-node.html#uninstall-node-1"><code>uninstall-node</code>(1)</a>,
<a href="uninstall-node-dcom.html#uninstall-node-dcom-1"><code>uninstall-node-dcom</code>(1)</a>,
<a href="uninstall-node-ssh.html#uninstall-node-ssh-1"><code>uninstall-node-ssh</code>(1)</a>,
<a href="update-node-config.html#update-node-config-1"><code>update-node-config</code>(1)</a>,
<a href="update-node-ssh.html#update-node-dcom-1"><code>update-node-dcom</code>(1)</a>,
<a href="update-node-ssh001.html#update-node-ssh-1"><code>update-node-ssh</code>(1)</a></p>
</div>
</div>
</div>

<hr />

<table width="90%" id="bottom-nav" cellspacing="0" cellpadding="0">
	<colgroup>
		<col width="12%"/>
		<col width="12%"/>
		<col width="*"/>
	</colgroup>
	<tr>		
		<td align="left">
		<a href="create-network-listener.html">
			<span class=" vector-font"><i class="fa fa-arrow-circle-left" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Previous</span>
		</a>
		</td>

		<td align="left">
		<a href="create-node-dcom.html">
			<span class="vector-font"><i class="fa fa-arrow-circle-right vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Next</span>
		</a>
		</td>

		<td align="right">
		<a href="toc.html">
			<span class="vector-font"><i class="fa fa-list vector-font" aria-hidden="true"></i></span>
			<span style="position:relative;top:-2px;">Contents</span>
		</a>
		</td>
	</tr>
</table>

<span id="copyright">
        <img src="/resource/reference/img/eclipse_foundation_logo_tiny.png" height="20px" alt="Eclipse Foundation Logo" align="top"/>&nbsp;            
        <span >Copyright&nbsp;&copy;&nbsp;2019,&nbsp;Oracle&nbsp;and/or&nbsp;its&nbsp;affiliates.&nbsp;All&nbsp;rights&nbsp;reserved.</span>
</span>

</body>
</html>
